home *** CD-ROM | disk | FTP | other *** search
/ Mac Magazin/MacEasy 52 / Mac Magazin and MacEasy Magazine CD - Issue 52.iso / Updates / Stata 5.0 Ado-files / ado.sea / newado / svyreg.hlp < prev    next >
Text File  |  1998-11-22  |  6KB  |  154 lines
  1. .-
  2. help for ^svyreg^, ^svylogit^, ^svyprobt^                       (manual:  ^[R] svyreg^)
  3. .-
  4.  
  5. Linear, logistic, and probit regressions for survey data
  6. --------------------------------------------------------
  7.  
  8.     ^svyreg^   varlist [weight] [^if^ exp] [^in^ range] [^,^ common_options]
  9.  
  10.     ^svylogit^ varlist [weight] [^if^ exp] [^in^ range] [^, or^ common_options
  11.                              maximize_options ]
  12.  
  13.     ^svyprobt^ varlist [weight] [^if^ exp] [^in^ range] [^,^ common_options
  14.                              maximize_options ]
  15.  
  16. where common_options are
  17.  
  18.         ^nocon^stant ^str^ata^(^varname^) psu(^varname^) fpc(^varname^)^
  19.         ^sub^pop^(^varname^) srs^subpop ^noadj^ust
  20.         ^l^evel^(^#^) p^rob ^ci deff deft meff meft^
  21.  
  22. These commands share the features of all estimation commands; see help @est@.
  23. The commands typed without arguments redisplay previous results.  The 
  24. following options may be given when redisplaying results
  25.  
  26.         ^l^evel^(^#^) p^rob ^ci deff deft meff meft^
  27.  
  28. ^svyreg^ allows ^pweight^s and ^iweight^s.  ^svylogit^ and ^svyprobit^ allow ^pweight^s.
  29. See help @weights@.
  30.  
  31. Warning:  Use of ^if^ or ^in^ restrictions will not produce correct variance
  32.           estimates for subpopulations in many cases.  To compare estimates
  33.           for subpopulations, use the ^by()^ or ^subpop()^ options.  
  34.  
  35.  
  36. Description
  37. -----------
  38.  
  39. These commands estimate regression models for complex survey data.
  40.  
  41. ^svyreg^ estimates linear regression.
  42.  
  43. ^svylogit^ estimates pseudo-maximum-likelihood logistic regression.
  44.  
  45. ^svyprobt^ estimates pseudo-maximum-likelihood probit model.
  46.  
  47. The dependent variable for ^svylogit^ and ^svyprobt^ should be a 0/1 variable
  48. (or, more precisely, a zero/nonzero variable).
  49.  
  50. The commands allow any or all of the following:  probability sampling weights,
  51. stratification, and clustering.  Associated variance estimates, design effects
  52. (deff and deft), and misspecification effects (meff and meft) are computed.
  53. The ^subpop()^ option will give estimates for a single subpopulation.  For a
  54. general discussion of various aspects of survey designs, including multistage
  55. designs, see ^[U] 36 Overview of survey estimation^.
  56.  
  57. To describe strata and PSUs of your data and to handle the error message
  58. "stratum with only one PSU detected", see help @svydes@.
  59.  
  60. To estimate linear combinations of coefficients and odds ratio for any
  61. covariate group relative to another, see help @svylc@.  To perform hypothesis
  62. tests, see help @svytest@.
  63.  
  64. See help @_robust@ for a programmer's command that can compute variance
  65. estimates for survey data for a user-defined program.
  66.  
  67.  
  68. Options
  69. -------
  70.  
  71. ^noconstant^ estimates a model with an intercept.
  72.  
  73. ^strata()^, ^psu()^, and ^fpc()^ are described in ^svyset^; see help @svyset@.
  74.  
  75. ^by(^varlist^)^ specifies that estimates be computed for the subpopulations
  76.     defined by different values of the variable(s) in the varlist.
  77.  
  78. ^subpop(^varname^)^ specifies that estimates be computed for the single
  79.     subpopulation defined by the observations for which varname~=0.
  80.     Typically, varname=1 defines the subpopulation and varname=0 indicates
  81.     observations not belonging to the subpopulation.  For observations whose
  82.     subpopulation status is uncertain, varname should be set to missing.
  83.  
  84. ^srssubpop^ can only be specified if ^by()^ or ^subpop()^ is specified.  ^srssubpop^
  85.     requests that deff and deft be computed using an estimate of simple-
  86.     random-sampling variance for sampling within a subpopulation.  If
  87.     ^srssubpop^ is not specified, deff and deft are computed using an estimate
  88.     of simple-random-sampling variance for sampling from the entire
  89.     population.  Typically, ^srssubpop^ would be given when computing
  90.     subpopulation estimates by strata or by groups of strata.
  91.  
  92. ^noadjust^ specifies that the model Wald test be carried out as W/k distributed
  93.     F(k,d), where W is the Wald test statistic, k is the number of terms in
  94.     the model excluding the constant, d = total number of sampled PSUs minus
  95.     total number of strata, and F(k,d) is an F distribution.  By default, an
  96.     adjusted Wald test is conducted:  (d-k+1)W/(kd) distributed F(k,d-k+1).
  97.  
  98. ^or^ (^svylogit^ only) reports the estimated coefficients transformed to odds
  99.     ratios, i.e., exp(b) rather than b.  Standard errors and confidence
  100.     intervals are similarly transformed.
  101.  
  102. ^level(^#^)^ specifies the confidence level (i.e., nominal coverage rate), in
  103.     percent, for confidence intervals; see help @level@.
  104.  
  105. ^prob^ requests that the t statistic and p-value be displayed.  The degrees of
  106.     freedom for the t are d = total number of sampled PSUs minus the total
  107.     number of strata (regardless of the number of terms in the model).  If no
  108.     display options are specified then, by default, the t statistic and p-
  109.     value are displayed.
  110.  
  111. ^ci^ requests that confidence intervals be displayed.  If no display options are
  112.     specified then, by default, confidence intervals are displayed.
  113.  
  114. ^deff^ requests that the design-effect measure deff be displayed.  See 
  115.     ^[R] svymean^ for details.
  116.  
  117. ^deft^ requests that the design-effect measure deft be displayed.  See 
  118.     ^[R] svymean^ for details.
  119.  
  120. ^meff^ requests that the meff measure of misspecification effects be displayed.
  121.     See ^[R] svymean^ for details.
  122.  
  123. ^meft^ requests that the meft measure of misspecification effects be displayed.
  124.     See ^[R] svymean^ for details.
  125.  
  126. maximize_options control the maximization process; see ^[R] maximize^.  You
  127.     should never have to specify them.
  128.  
  129.  
  130. Examples
  131. --------
  132.  
  133.     . ^svyset pweight leadwt^
  134.     . ^svyset strata strata^
  135.     . ^svyset psu psu^
  136.  
  137.     . ^svyreg loglead age female black race region2-region4^
  138.  
  139.     . ^svylogit highbp height weight age age2 female^
  140.     . ^svylogit, or^
  141.  
  142.     . ^svylogit highlead age, subpop(female) or^
  143.  
  144.  
  145. Also see
  146. --------
  147.  
  148.  Manual:  ^[U] 26 Estimation and post-estimation commands^
  149.       ^[U] 35 Overview of model estimation^
  150.           ^[U] 36 Overview of survey estimation^
  151.       ^[R] svyreg^
  152. On-line:  help for @lincom@, @_robust@, @svy@, @svydes@, @svylc@, @svymean@, @svyset@,
  153.            @svytest@
  154.